home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / grafik / bildanzeiger / seepix / seepix.doc < prev    next >
Text File  |  1995-03-09  |  11KB  |  251 lines
  1.  
  2.                              SeePix -- v4.0
  3.                              ~~~~~~~~~~~~~~
  4.                               Hank Schafer
  5.                             November 15, 1992
  6.  
  7.  
  8. Legalese:
  9. ~~~~~~~~~
  10. SeePix is Copyright © 1992 by Hank Schafer; All Rights Reserved.
  11.  
  12. SeePix is free software; you can redistribute it and/or modify it under the
  13. terms of the GNU General Public License as published by the Free Software
  14. Foundation, either version 1, or (at your option) any later version.
  15.  
  16. SeePix is distributed in the hope that it will be useful, but WITHOUT ANY
  17. WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  18. FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
  19. details.
  20.  
  21. You should have received a copy of the GNU General Public License along
  22. with this program; if not, write to:
  23.  
  24.         Free Software Foundation, Inc.
  25.         675 Massachusetts Ave.
  26.         Cambridge  MA  02139, USA
  27.  
  28.  
  29. What SeePix Is:
  30. ~~~~~~~~~~~~~~~
  31. SeePix is an IFF ILBM picture viewer.  It handles HAM, Extra-Halfbrite
  32. and OverScan pix, of course, it can also handle 16 or 32 Color
  33. [LO,MED,HI]-RES pix. It adjusts to the machine it's on (NTSC or PAL).
  34. It can be invoked from either the Shell/CLI or Workbench.  SeePix
  35. features an ARP interface, Iconization and the PathMaster File Selector.
  36. The most important feature of SeePix is the ability to modify the colors of
  37. a pic BEFORE printing, without modifying the pic itself.
  38.  
  39. NOTE: As of Release v4.0 the ARP File Requester has been reinstated as
  40. a compile-time option.  However, since I'm partial to the PathMaster, the
  41. executable I'm distributing is sans the ARP FileReq.  So, if you received
  42. this program with the source, and compile it using the ARP FileReq, then
  43. just assume every mention of PathMaster below to refer to ARP instead.  The
  44. exception to this are references to quitting the program from the requester
  45. and deleting of files (these aren't implemented with the ARP FileReq).
  46.  
  47.  
  48. Workbench Usage:
  49. ~~~~~~~~~~~~~~~~
  50.         Simply hold down the [SHIFT] key and single-click the icon(s) of
  51.         the pix you want to see, then double-click the SeePix icon OR
  52.         single-click the SeePix Icon and hold down the [SHIFT] key and
  53.         select the icon(s) of the pix you want to see, double-clicking
  54.         the LAST pix icon.  Either method opens a small window at the top
  55.         of your Workbench screen, which shows you the name of the file,
  56.         and it's status, i.e., "Loading..." or "Done." or "Not an IFF File!"
  57.  
  58.                 OR
  59.  
  60.         Just double-click the SeePix Icon, and you'll be greeted with
  61.         the PathMaster File Selector.  This method does not open a status
  62.         window.
  63.  
  64.  
  65. Shell/CLI Usage:
  66. ~~~~~~~~~~~~~~~~
  67.         SeePix [VERSION] [HELP] [NOMODE]/[LACE] [CYCLE] [File(s)/WildCards]
  68.         Both AmigaDOS (#?) & ARP (*) wildcards are supported.
  69.  
  70.                 VERSION - Displays Version & Creation Date.
  71.                 HELP    - Displays the Shell/CLI Usage your'e reading now.
  72.                 NOMODE  - Force scrollmode (ignore HIRES/LACE).
  73.                 LACE    - Force interlaced display mode.
  74.                 CYCLE   - Force color cycling on startup.
  75.  
  76.                         NOTE: NOMODE and LACE are mutually exclusive.
  77.  
  78.  
  79. File Specification:
  80. ~~~~~~~~~~~~~~~~~~~
  81.         Both the AmigaDOS wildcard specification (#?) and the ARP wildcard
  82.         specification (*) are supported.  What does this mean?  Invoke
  83.         SeePix from the Shell/CLI, doing it this way:
  84.  
  85.         SeePix DF1:Pictures/#? - Will show all pix on drive DF1: in the
  86.                                  directory "Pictures".
  87.  
  88.         SeePix DH1:Graphics/DirtyPix/* -
  89.                                  Will show all pix on drive DH1: in the
  90.                                  directory "Graphics" and the sub-directory
  91.                                  "DirtyPix".
  92.  
  93.         Alternately, you may specify the filename(s) of the pix you want
  94.         to see:
  95.  
  96.         SeePix DF0:Pic1 DF2:Pic2 DH1:Pic3 -
  97.                                   Shows Pic1 on DF0:, Pic2 on DF2: and
  98.                                   Pic3 on DH1:, what could be simpler?
  99.  
  100.         Suppose you're already in the directory where you keep all the
  101.         pix you want to see, then just issue the command:
  102.  
  103.         SeePix *
  104.            OR
  105.         SeePix #? -
  106.                                    Shows all the pix in the current
  107.                                    directory.
  108.  
  109.  
  110. What the Shell/CLI Options mean...
  111. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  112.         VERSION...
  113.                 Shows the Version and compilation date of the executable.
  114.  
  115.         HELP...
  116.                 Gives the "Usage:" statement at the beginning of this
  117.                 document.
  118.  
  119.                 NOTE: The escape sequences which were used extensively in
  120.                 formatting the output of the VERSION & HELP Options have
  121.                 been removed, resulting in a smaller executable.
  122.                 (SeePix v3.4)
  123.  
  124.         NOMODE...
  125.                 This is MOST effective on HI-RES+LACE pix, as you'll get a
  126.                 display that's 4 times the normal size, which you can
  127.                 scroll around in and 'zoom' in on the best parts.  With
  128.                 LACE (only) pix, you get a display that's twice as tall. Of
  129.                 course, with HI-RES (only) - display is twice as wide.
  130.  
  131.         LACE... Has no effect on LACE pix, but on non-interlace pix,
  132.                 halves the height of the pic and presents it in LACE mode.
  133.  
  134.         CYCLE...
  135.                 This is useful only on pix which have been done using
  136.                 cycle paint...  If using CYCLE and one of the pix in your
  137.                 command line arg happens to be HAM, SeePix might crash on
  138.                 some Amigas, (HAM pix aren't normally cycle-painted.)
  139.  
  140. If SeePix is invoked from the Shell/CLI without file specifications (or the
  141. VERSION/HELP args above), you'll be greeted with the PathMaster File
  142. Selector (See PathMaster.Doc for ALL the details, but it's self explanatory,
  143. really!).
  144.  
  145. To view OverScan pix, use the ARROW keys (not the keypad) or press the left
  146. mouse button with the cursor at one of the pic borders.
  147.  
  148. New to SeePix v3.7 is the ability to delete files.  Just use the "Delete"
  149. Button on the PathMaster File Selector.
  150.  
  151.  
  152. The SeePix Menu...
  153. ~~~~~~~~~~~~~~~~~~
  154. Once in SeePix, pressing the right mouse button near the upper left corner of
  155. the screen will reveal a menu with a few choices, here is a summary:
  156.  
  157. About SeePix...  [Right-AMIGA A] -
  158.  
  159.         Brings up a little requester with some shameless horn-blowing
  160.         and brief instructions.  The Hot-Key for this item now works
  161.         properly. (SeePix v3.3)
  162.  
  163. Toggle Title Bar [Right-AMIGA T] -
  164.  
  165.         Does what it says.
  166.  
  167. Toggle Cycling   [Right-AMIGA C] -
  168.  
  169.         Toggles cycling on and off.  Cycling can also be invoked by
  170.         the [TAB] key (for you DeluxePaint fanatics!).
  171.  
  172. Print Pic        [Right-AMIGA P] -
  173.  
  174.         Changes your cursor to a small crossbar with the designation
  175.         "size" next to it. click on the 1st corner of the area you
  176.         wish to print, and while holding down the left mouse button,
  177.         drag the box to cover the entire area you wish to print, then
  178.         release the left mouse button.  The area chosen will then be
  179.         sent to the printer.
  180.  
  181. Modify Colors    [Right-AMIGA M] -
  182.  
  183.         Brings up a palette requester allowing experimentation with new
  184.         colors.  You can't change the colors on a permanent basis,
  185.         but if your print-out isn't what you'd like it to be (i.e. Blue
  186.         is printed Purple), you can "tweak" the colors until the print-out
  187.         is what you expect; likewise, if a picture has a solid color
  188.         background; Red, for instance, you could change that color to
  189.         white to save ribbon or ink.  After color modification, click on
  190.         the "OK" gadget and you're given the same cursor mentioned in
  191.         "Print Pic" above.  You MUST click on "OK" to invoke printing,
  192.         clicking on "CANCEL" just quits the palette function, without
  193.         taking you to the presses.  If for some reason you don't want to
  194.         print, and have clicked on the "OK" gadget, just click the left
  195.         mouse button once and release.  This action allows you to bypass
  196.         printing.
  197.  
  198.         Getting the appropriate results for your color printer using this
  199.         method, is by necessity, a matter of trial and error.  However,
  200.         once you've mastered the modifications required for your
  201.         particular printer, it becomes second nature.  You'll develop a
  202.         "baseline formula" for your particular printer, that should only
  203.         require minor adjustments for each picture.  Oh, don't think that
  204.         only COLOR printers can benefit from color modification, B&W
  205.         printers can too!
  206.  
  207.         By default, the palette requester comes up allowing you to modify
  208.         the RGB values of the picture, though not apparent, if you click
  209.         on the "RGB" labels (next to the sliders) of the requester, they
  210.         will change to HSL (Hue, Saturation, Luminance).  Some people
  211.         prefer to use this method of palette control. It's your choice.
  212.  
  213.         NOTE:  New to SeePix v3.3: the menu colors are determined
  214.         by the pic palette.  Making it possible to modify the colors
  215.         in such a manner as to make the menu items invisible (Learn
  216.         those HotKeys!).
  217.  
  218. Iconify          [Right-AMIGA I] -
  219.  
  220.         The boss walks in while you're looking at the latest T&A picture
  221.         you downloaded during your lunch hour, this option turns SeePix
  222.         into a small "SeePix" icon in the center of your screen (Yeah,
  223.         right, like you're actually using your Amiga at work!).
  224.         Double-clicking on the icon will, depandant upon your method of
  225.         startup, either give you the PathMaster File Selector, or the
  226.         next Pic.
  227.  
  228. Next Pic         [Right-AMIGA N] -
  229.  
  230.         Takes you to the next picture specified on the Shell/CLI Command
  231.         line, or if none specified (or invoked via WorkBench with no
  232.         extended-select) gives you the PathMaster File Selector.  This
  233.         item is "ghosted" if you're looking at the last pic, when invoked
  234.         either from Workbench (extended select) or from Shell/CLI if
  235.         filenames have been given as arguments (not wildcards).
  236.  
  237. Quit SeePix      [Right-AMIGA Q] - Quits SeePix.
  238.  
  239.  
  240.                    ---===] NOTE! NOTE! NOTE! NOTE! [===---
  241.  
  242.      The executable SeePix in this distribution has been compressed using
  243.      PowerPacker.  This does not impact the viewing of OverScan pix, and
  244.      offers a large (43,944 Bytes -> 25,816 Bytes; saving 18,098 Bytes for
  245.      a 42% savings) reduction in the size of the final executable.
  246.  
  247.  
  248. That's it, I hope you enjoy SeePix!
  249. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  250.  
  251.